home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / ifl / TIFFReadEncodedTile.z / TIFFReadEncodedTile
Encoding:
Text File  |  1998-10-20  |  3.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddEEEEnnnnccccooooddddeeeeddddTTTTiiiilllleeee((((3333TTTT))))              IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFReadEncodedTile - read and decode a tile of data from an open TIFF
  10.      file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  14.      iiiinnnntttt TTTTIIIIFFFFFFFFRRRReeeeaaaaddddEEEEnnnnccccooooddddeeeeddddTTTTiiiilllleeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, uuuu____lllloooonnnngggg ttttiiiilllleeee,,,, uuuu____cccchhhhaaaarrrr**** bbbbuuuuffff,,,, uuuu____lllloooonnnngggg ssssiiiizzzzeeee))))
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      Read the specified tile of data and place up to _s_i_z_e bytes of
  18.      decompressed information in the (user supplied) data buffer.
  19.  
  20. NNNNOOOOTTTTEEEESSSS
  21.      The value of _t_i_l_e is a ``raw tile number.''  That is, the caller must
  22.      take into account whether or not the data are organized in separate
  23.      planes (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).  _T_I_F_F_C_o_m_p_u_t_e_T_i_l_e automatically does this
  24.      when converting an (x,y,z,sample) coordinate quadruple to a tile number.
  25.      To read a full tile of data the data buffer should be at least as large
  26.      as the value returned by _T_I_F_F_T_i_l_e_S_i_z_e.
  27.  
  28.      The library attempts to hide bit- and byte-ordering differences between
  29.      the image and the native machine by converting data to the native machine
  30.      order.  Bit reversal is done if the _F_i_l_l_O_r_d_e_r tag is opposite to the
  31.      native machine bit order.  16- and 32-bit samples are automatically
  32.      byte-swapped if the file was written with a byte order opposite to the
  33.      native machine byte order,
  34.  
  35. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  36.      The actual number of bytes of data that were placed in _b_u_f is returned;
  37.      _T_I_F_F_R_e_a_d_E_n_c_o_d_e_d_T_i_l_e returns -1 if an error was encountered.
  38.  
  39. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  40.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_R_e_a_d_R_a_w_T_i_l_e(3T), _T_I_F_F_R_e_a_d_T_i_l_e(3T)
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.